##############################################################################
###+---------+################################################################
#+-| UPPER() |---------------------------------+##############################
#| +---------+ Converts lowercase to UPPERCASE |##############################
#+---------------------------------------------+##############################
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE string.hdr     |##############################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |----------------------------------+#############################
#|     FUNCTION CHAR upper PROTOTYPE            |#############################
#|      PARAMETERS CONST CHAR source_string     |#############################
#+----------------------------------------------+#############################
##############################################################################
##############################################################################
##############+---| Description |-----------------------------+###############
##############| The upper() function returns a representation |###############
##############| of source_string where all of the lowercase   |###############
##############| characters have been converted to uppercase.  |###############
##############+-----------------------------------------------+###############
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########|                                                          |#########
#########| ? upper( "jbl m.d.")        && prints "JBL M.D."         |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########|                                                          |#########
#########| q = "some text"                                          |#########
#########| ? upper( q )                && prints "SOME TEXT"        |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 3 |-------------------------------------------+#########
#########|                                                          |#########
#########| ? upper(left("abcdEFG",4))  && prints "ABCD"             |#########
#########+----------------------------------------------------------+#########
##############################################################################